home *** CD-ROM | disk | FTP | other *** search
/ Die Speccy' 97 / Die Speccy' 97.iso / amiga_system / the_aminet / comm / fido / ttrxid18.lha / TrapTrxID.italiano.doc < prev   
Text File  |  1994-09-01  |  13KB  |  345 lines
  1.  
  2.  
  3.                \\\\\\\\\\\\\\\\\\\\////////////////////
  4.                               TrapTrxID
  5.                                  v1.8
  6.                           Time Synchronizer
  7.  
  8.                             Manuale Utente
  9.  
  10.                                   di
  11.                            Giuseppe Vicari
  12.                        2:331/106.1@Fidonet.Org
  13.                ////////////////////\\\\\\\\\\\\\\\\\\\\
  14.  
  15.  
  16.  
  17.  
  18. ****    Indice                                                   Linea
  19.  
  20.       . Che cos'e`?                                                 38
  21.       . A che cosa serve?                                           47
  22.       . Perche` usare TrapTrxID?                                    57
  23.       . Come si usa?                                                91
  24.       . Note particolari riguardanti TrapDoor?                     168
  25.       . Come funziona?                                             181
  26.       . Bug e problemi?                                            210
  27.       . Come contattare l'autore in caso di problemi?              216
  28.       . La storia di TrapTrxID?                                    224
  29.       . Quanto costa il programma?                                 300
  30.       . Chi bisogna ringraziare?                                   318
  31.       . Come assicurarsi dell'originalita` del programma?          332
  32.       . Fine del documento                                         344
  33.  
  34.  
  35. ****    Fine dell'indice
  36.  
  37.  
  38. >>>>    Che cos'e`?
  39.  
  40.     TrapTrxID  e`  un piccolo tool costruito per TrapDoor che permette
  41. di  sincronizzare  l'orologio  di sistema, utilizzando le informazioni
  42. che  si  trovano  nel file log di TrapDoor.  Tali informazioni vengono
  43. generate  durante  un collegamento di tipo EMSI con il nodo con cui ci
  44. si vuole sincronizzare.
  45.  
  46.  
  47. >>>>    A che cosa serve?
  48.  
  49.     Alcuni  nodi  possono  avere  l'ora di sistema sincronizzata con i
  50. "famosi"  orologi  atomici  per mezzo di apparecchiature particolari o
  51. tramite  collegamento  con  altri  nodi.   In questo modo, utilizzando
  52. TrapTrxID,  potrai  sempre  avere  il  tuo  orologio regolato sull'ora
  53. esatta.   Per  fare  questo  ci si collega al nodo con cui ci si vuole
  54. sincronizzare con TrapDoor e poi si lancia TrapTrxID.
  55.  
  56.  
  57. >>>>    Perche` usare TrapTrxID?
  58.  
  59.     Questo  programma,  rispetto a quelli gia` esistenti, offre alcuni
  60. vantaggi:
  61.  
  62.     1. E`  stato  concepito  per essere il piu` corto e il piu` veloce
  63.        programma sulla faccia della terra ;-)
  64.  
  65.     2. Analizza  completamente il file di log evitando di perdere dati
  66.        qualora   l'ultima  sessione  fosse  risultata  particolarmente
  67.        lunga.
  68.  
  69.     3. Con  una  particolare  opzione  permette di analizzare solo una
  70.        porzione del file log.
  71.  
  72.     4. Informa il sistema dell'avvenuta sincronizzazione scrivendo una
  73.        linea nel file di log di TrapDoor.
  74.  
  75.     5. Utilizzando  la  riga  inserita  nel  file  di  log,  evita  di
  76.        risincronizzare  l'ora  di sistema se si riesegue piu` volte il
  77.        programma.
  78.  
  79.     6. Possibilita`  di  sincronizzarsi,  con una sola analisi, a piu`
  80.        nodi.
  81.  
  82.     7. Possibilita`  di  controllare  il  valore massimo di correzione
  83.        dell'orologio.
  84.  
  85.     8. Possibilita`  di  sincronizzarsi  con sistemi che si trovano in
  86.        fusi orari diversi.
  87.  
  88.     9. Possibilita` di sincronizzare l'orologio interno.
  89.  
  90.  
  91. >>>>    Come si usa?
  92.  
  93.     TrapTrxID  richiede  KickStart  v2.0+  (un'altra buona ragiore per
  94. fare l'upgrade).
  95.  
  96.     TrapTrxID  si puo` usare in due modi:  puo` essere eseguito da CLI
  97. o   da   un   particolare   file   script   (ad  es.   User-StartUp  o
  98. StartUp-Sequence);  il secondo modo consiste nel lanciare TrapTrxID al
  99. termine  di  una  sessione  EMSI:   in questo modo la sincronizzazione
  100. avviene  ad ogni sessione.  Questa possibilita e` offerta dall'opzione
  101. AFTERSESSION  di  TrapDoor  (cfr.   documenti allegati al pacchetto di
  102. TrapDoor).
  103.  
  104.     I parametri da passare a TrapTrxID sono sette:
  105.  
  106. 1)  LOGNAME, il nome completo del file di log di TrapDoor, comprensivo
  107.     del path per raggiungere il file (parametro obbligatorio).
  108.  
  109. 2)  NODE,  una  lista  dei  numeri  dei  nodi  con  cui  ci  si  vuole
  110.     sincronizzare nel formato <nodo>,<errmax>,<zona>.
  111.     <nodo>   - un'espressione   regolare   in   formato  AmigaDOS  che
  112.                identifica il nodo con cui sincronizzarsi;
  113.     <errmax> - il  valore  massimo dello scarto fra i due orologi.  Se
  114.                viene    superato   la   sincronizzazione   non   viene
  115.                considerata  valida.   La  mancanza  del parametro o il
  116.                valore  0  significano  che tale valore non deve essere
  117.                considerato.
  118.     <zona>   - il  valore  del  fuso orario del nodo remoto rispetto a
  119.                quello   locale.    Questo  parametro  e`  nella  forma
  120.                <ore>:<minuti>   (ad  esempio  1:30  significa  che  la
  121.                differenza  tra l'ora del nodo remoto e quella del nodo
  122.                locale  e`  di  1  ora  e  30 minuti).  Per difetto, la
  123.                sincronizzazione  avverra` con l'ultimo nodo con cui si
  124.                e` avuta una sessione EMSI.
  125.  
  126. 3)  NOUPDATE, usare questo flag se si vuole che TrapTrxID non aggiorni
  127.     l'orologio.   E' comodo durante i test o per verificare il proprio
  128.     orologio.
  129.  
  130. 4)  ASK,  usare  questo  flag  se  si  vuole  che TrapTrxID chieda una
  131.     conferma prima di settare l'ora.
  132.  
  133. 5)  SET,  usare  questo  il  flag  se  si  vuole  sincronizzare  anche
  134.     l'orologio interno.
  135.  
  136. 6)  BUFFER, definisce le dimensioni del buffer interno in byte, valore
  137.     di  default  e` di 8192, mentre quello minimo e` di 256; un valore
  138.     alto  di questo parametro accelera notevolmente le prestazioni del
  139.     programma  (specialmente  se  il  file  di  log  si  trova  su una
  140.     periferica lenta).
  141.  
  142. 7)  TAIL,  dice a TrapTrxID di analizzare solo l'ultima parte del file
  143.     di  log.   Per  default,  analizza  l'intero  file; questa opzione
  144.     permette di accelerare notevolemente l'analisi del file di log, ma
  145.     va  usata molto prudentemente pena la non sicronizzazione.  Valore
  146.     consigliato 10240, equivalente a 10Kbyte.
  147.  
  148.     Questa e` il template del comando:
  149.  
  150. LOGNAME/A,NODE/M,NOUPDATE/S,ASK/S,SET/S,BUFFER/N,TAIL/N
  151.  
  152.     Esempio (da CLI):
  153.  
  154. TrapTrxID Mail:Logs/TrapDoor.log 2:333/100.0
  155.  
  156.     Inserire questa stringa in un file di script o usarla per lanciare
  157. TrapTrxID da CLI.
  158.  
  159.     Esempio (da TrapDoor):
  160.  
  161. AFTERSESSION "TrapTrxID %l 2:333/100.0"
  162.  
  163.     Inserire  questa  stringa  nel file di configurazione di TrapDoor.
  164. La stringa %l viene sostituita automaticamente da TrapDoor con il nome
  165. completo del file di log.
  166.  
  167.  
  168. >>>>    Note particolari riguardanti TrapDoor?
  169.  
  170.     Questa  versione  di  TrapTrxID e` stata sviluppata utilizzando la
  171. versione  1.83  di TrapDoor.  Versioni piu` datate di TrapDoor possono
  172. egualmente  funzionare,  purche`  permettano la ricezione dei messaggi
  173. TrxId,  Name o AKA (fai riferimento alla documentazione della versione
  174. di TrapDoor di cui sei in possesso).
  175.  
  176.     Menzione particolare merita il file di configurazione di TrapDoor.
  177. Affinche`  TrapTrxID possa funzionare correttamente, e` necessario che
  178. in tale file compaia la stringa LOGLEVEL 8:n, con n maggiore di 2.
  179.  
  180.  
  181. >>>>    Come funziona?
  182.  
  183.     TrapTrxID funziona semplicemente cercando nel file di log le linee
  184. di tipo
  185.  
  186. : 26-Dec-92 12:11:01   Name: Nome BBS (2:334/155.0)
  187. : 26-Dec-92 12:11:01    AKA: 2:23331/1.0 3:1/1.0
  188.  
  189. e  verificando che l'indirizzo specificato come parametro coincida con
  190. uno  di  quelli  presenti  in  queste  due  linee.  Se cio` avviene la
  191. prossima linea di tipo
  192.  
  193. : 26-Dec-92 12:11:01  TrxID: 2b3c4bd0/2b3c4ad7
  194.  
  195. servira` per calcolare la differenza temporale tra il proprio orologio
  196. di  sistema  e  quello  del  nodo  col  il  quale abbiamo eseguito una
  197. sessione  EMSI, esattamente calcolando la differenza dei due parametri
  198. esadecimali,  presenti  dopo  la  parola  chiave  TrxID:, ricavando la
  199. differenza  in  secondi  dell'ora  del nodo locale con quella del nodo
  200. remoto.   Naturalmente questa operazione viene fatta considerando solo
  201. l'ultima   sessione.   Una  volta  che  l'orologio  viene  aggiornato,
  202. TrapTrxID aggiunge una linea di tipo
  203.  
  204. " 26-Dec-92 12:34:24  Adjusted by -4:09 [725371856] (3:1/1.0)
  205.  
  206. in  modo  da  prevenire che TrapTrxID riaggiorni l'orologio fino a una
  207. nuova sessione EMSI.
  208.  
  209.  
  210. >>>>    Bug e problemi?
  211.  
  212.     Fino  ad  oggi  non  ho  riscontrato  nessun tipo di bug in questo
  213. programma.
  214.  
  215.  
  216. >>>>    Come contattare l'autore in caso di problemi?
  217.  
  218.     Per  ogni  eventuale  problema  o  bug  da me non rilevato, potete
  219. contattarmi al seguente indirizzo e-mail:
  220.  
  221.                Giuseppe Vicari 2:331/106.1@Fidonet.Org
  222.  
  223.  
  224. >>>>    La storia di TrapTrxID?
  225.  
  226.     . v1.8 1 Sep 94:
  227.  
  228.         Corretto  un  piccolo  bug insignificante e ricompilato con il
  229.         GCC v2.6.0.
  230.  
  231.     . v1.7 20 Mar 94:
  232.  
  233.         Corretto un piccolo bug insignificante.
  234.  
  235.     . v1.6 15 Mar 94:
  236.  
  237.         Rivoluzione!
  238.     - possibilita`  di  inserire nodi multipli (sono state cambiate le
  239.       procedure per la gestione delle sincronizzazioni);
  240.     - gestione dell'errore massimo di sincronizzazione;
  241.     - gestione dei fusi orari (vedi manuale);
  242.     - opzione TAIL (vedi manuale);
  243.     - quando modifica l'ora interna mostra la nuova data;
  244.     - l'istante  di  sincronizzazione e` aggionto (in paretesi quadre)
  245.       nella linea "Adjusted by";
  246.     - gestione dei nodi in standard 5D (es.  1:2/3.4@fidonet.org);
  247.     - ottimizzazione di alcune procedure;
  248.     - utilizzo delle funzioni di I/O non bufferizzate;
  249.     - ridotta la dimensione dello stack utilizzato;
  250.     - ridotte le dimensioni dell'eseguibile del 50.2% (-3548 byte);
  251.     - aumento  della  velocita` (su un Amiga con 68000, con un file di
  252.       log di circa 1Mbyte, un buffer interno di 8Kbyte risulta 6 volte
  253.       piu` veloce);
  254.     - ora e` disponibile la TrapTrxID.guide.
  255.  
  256.         TrapTrxID   rimane   comunque   compatibile  con  la  versione
  257.     precedente.
  258.  
  259.     . v1.5 1 Aug 93:
  260.  
  261.         Nuovo flag NOUPDATE, vedi manuale.
  262.  
  263.     . v1.4 7 Apr 93:
  264.  
  265.         E`  stato  rifatto  il  codice utilizzando le funzioni tipiche
  266.     dell'AmigaDOS  ottenendo  un  codice  eseguibile  decisamente piu`
  267.     corto,   e  piu`  efficiente;  il  parser  di  linea  e`  AmigaDOS
  268.     compatibile;  alterata  la  linea che scrive TrapTrxID nel file di
  269.     log  (mantenendo  la  compatibilita`  con  le  vecchie  versioni);
  270.     aggiunta  l'opzione  BUFFER;  aggiunta  del  flag  ASK  e  SET; e`
  271.     disponibile il manuale in inglese.
  272.         Prova "version TrapTrxID" ;-).
  273.  
  274.     . v1.3 31 Jan 93:
  275.  
  276.         E`  stato  sistemato  un  difetto  che  mandava  in  crash  il
  277.     calcolatore, a causa dell'ottimizzatore del compilatore.
  278.  
  279.     . v1.2 30 Jan 93:
  280.  
  281.         Ora  e`  possibile non specificare il nome del nodo con cui ci
  282.     si   vuole   sincronizzare,  in  questo  modo  verra`  considerato
  283.     l'ultimo.   Nel caso venga lanciato da WorkBench il programma apre
  284.     una   finestra  e,  dopo  aver  mostrato  la  sintassi  d'uso  del
  285.     programma,  la  richiude  dopo  5  secondi.   E` stata cambiata la
  286.     funzione main() con la _main(), rendendo il codice piu` corto.
  287.  
  288.     . v1.1 22 Jan 93:
  289.  
  290.         Corretto un piccolo bug insignificante (nel file log, scriveva
  291.     l'ora senza lo zero davanti alla cifra se era minore di 10; es.  9
  292.     invece  di  09),  aggiunto  un messaggio d'errore, e riottimizzate
  293.     alcune parti del programma.
  294.  
  295.     . v1.0 3 Jan 93:
  296.  
  297.         Prima versione.
  298.  
  299.  
  300. >>>>    Quanto costa il programma?
  301.  
  302.     Il  programma  puo`  essere  distribuito  e  usato  liberamente  e
  303. gratuitamente, purche` non alteriate nessuna sua parte:  ne` il codice
  304. ne`  la  documentazione  allegata.   Questo e` un programma FD (Freely
  305. Distributable).   Tuttavia  saro`  molto  lieto di accettare qualunque
  306. offerta  di  denaro $-), anzi desidererei molto ricevere una cartolina
  307. del vostro paese, anzi una bella cartolina.  L'indirizzo per ogni tipo
  308. di offerta e` il seguente:
  309.  
  310.                            Giuseppe Vicari
  311.                              via Torni, 7
  312.                          I-21051 Arcisate VA
  313.                                 ITALIA
  314.  
  315.     Ringrazio anticipatamente ogni vostra offerta.
  316.  
  317.  
  318. >>>>    Chi bisogna ringraziare?
  319.  
  320.     Vorrei ringraziare le seguenti persone:
  321.  
  322. Matteo Taveggia
  323.     per la correzione e traduzione in inglese dei manuali.
  324.  
  325. Flavio Stanchina e Maurizio Frizzo
  326.     per i loro suggerimenti.
  327.  
  328. Maximilian Hantsch e Martin J. Laubach
  329.     per il loro stupendo programma TrapDoor.
  330.  
  331.  
  332. >>>>    Come assicurarsi dell'originalita` del programma?
  333.  
  334.     All'interno   dell'archivio   e`   stato  inserito  un  programma,
  335. CheckFiles, per verificare l'integrita` e l'originalita` del programma
  336. e  del  manuale.   In  questo  modo  tutti  potranno controllare se il
  337. programma  e`  stato  manomesso da qualcuno o addirittura infettato da
  338. qualche  virus.   Dopo aver estratto i file dall'archivio si lancia il
  339. programma  CheckFiles  (attenzione  a  come  scrivi:   il  comando  e`
  340. case-sensitive)  all'interno  della  directory  dove si trovano i file
  341. estratti; il programma vi segnalera` i file che sono stati alterati.
  342.  
  343.  
  344. >>>>    Fine del documento
  345.